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ABSTRACT 

This  report  describes  how  to  use  the  Syndia/Syngra 
system  available  at  SU-SCORE.  This  system  accepts  a 
BNF-like  grammar  specification  and  automatically  generates 
syntax  diagrams  on  a  Tektronix  graphics  terminal.  Syndia  is 
the  major  component  of  this  system;  Syngra  acts  as  an 
interface  between  Syndia  and  the  SUDS2  graphics  editor. 
Syndia  performs  no  ambiguity  or  consistency  checks  on  the 
BNF  input . 

This  report  assumes  that  the  reader  is  familiar  with 
BNF  and  syntax  diagram  representations  of  grammars. 


INDEX  TERMS:  Syndia,  automatic  syntax  diagram  generation, 
BNF,  Backus-Naur  Form,  language  documentation 
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1.0  INTRODUCTION 

Syndia  is  a  Pascal  program  which  reads  a  modilied-BNF 
description  and  writes  instructions  for  drawing  syntax 
diagrams  on  a  hypothetical  plotter.  One  drawing  is 
generated  lor  each  BNF  production. 

Syndia  is  now  available  at  SU-SCORE  and  is  interlaced 
to  the  SCORE  graphics  editor  SUDS  2  by  a  second  program 
Syngra.  This  manual  describes  the  use  ol  Syndia  and  Syngra 
along  with  the  input  lormat  required  by  Syndia. 

Syndia  was  originally  written  by  J.  Spillman  and  was 
modilied  and  extended  by  Karl  Jos  el  Bucher  at  Eidg. 
Techische  Hochschule  in  Zuerich.  Larry  Paulson  (Stanlord 
SAIL)  modilied  Syndia  to  run  under  TOPS-10.  Warren  Cory 
made  lurther  modifications  and  has  set  up  the  current 
working  version  on  SU-SCORE. 

This  manual  (minus  diagrams)  is  on-line  at  SU-SCORE  in 
DOC : SYNDI A . MAN .  The  original  Syndia  liles  lor  all  the 
examples  in  this  manual  are 

PS : <CSL . DA . SYNDI A>SME  1  , 

PS:<CSL.DA.SYNDIA>SME2, 

PS : <CSL . DA . SYNDI A>SHE3 .  and 
PS:<CSL.DA.SYNDIA>SYNDIA.SYN. 
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2.0  OVERVIEW 


A  Syndia  BNF  description  contains  three  major  sections. 
The  first  is  the  parameter  section.  In  this  section,  the 
user  specifies  what  output  should  be  generated,  the  width  of 
the  plots ,  etc . 


The  second  section,  the  symbol  declaration  section,  is 
optional.  Here  the  user  may  define  the  character  string 
values  of  identifiers.  This  is  useful  for  two  reasons: 


1.  The  user  may  define  short  abbreviations  for  long 
character  strings. 


2.  The  character  string  value  is  always  treated  as  an 
identifier,  even  if  it  contains  meta-characters  or 
keywords.  This  will  be  explained  in  more  detail  later. 


The  final  section  contains  the  BNF  productions.  This 
section  may  also  include  modifications  which  affect  the 
layout  of  individual  diagrams. 

These  three  sections  are  described  in  turn  in  Sections 
4,  5,  and  6.  following  a  discussion  of  identifiers  and 
constants  in  Section  3.  The  use  of  Syndia  and  Syngra  is 
explained  in  Section  7.  Finally,  a  complete  example  appears 
in  Section  8 . 
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3.0  SYNDIA  CHARACTER  SET.  IDENTIFIERS,  AND  CONSTANTS 
3 . 1  Character  Set 


Syndia  uses  the  following  character  set-. 


Upper  case  letters 
Digits 

Special  characters 


Blank 


A  -  2 
0-9 

•  "  t  *  y.  c  •  c  )  * 
+  ;  <  >  = 
?  9  l  )  \  A  _ 


The  remaining  printing  7-bit  ASCII  characters  are  "folded 
(upper-cased)  on  input  according  to  the  table  below.  Hence 
Syndia  will  not  recognize  the  characters  "{»,  "I" 
or  and  these  characters  should  not  appear  in  the  input 
Syndia  will  expand  tabs  (CTRL-I)  to  blanks;  othe 
non-printing  characters  are  ignored. 


ASCII  CHARACTERS: 

Lower  case  letters  a - z 
* 

{ 

) 

I 

DEL  (ASCII  code  177  octal) 


"FOLDED"  TO: 

Upper  case  letters 
9 
( 

1 

\ 

A 


A-Z 


NON-NTT*  CHM. 


Identifiers  in  Syndia  are  used  as  names  for  character 
strings.  The  syntax  for  identifiers  in  Syndia  is  more 
flexible  than  in  most  languages#  as  the  follouing  examples 
show : 

VALID  IDENTIFIERS: 

«*STAR»* 

.  +  1 

EXPRESSION 

# 

META*5{(  ),/:;  =  [  ]\ 

The  follouing  restrictions  apply  to  identifier  names: 


1.  Identifiers  longer  than  40  characters  are  truncated  to 
40  characters. 

2.  Blanks  cannot  be  embedded  in  identifiers. 
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3.  Identifiers  cannot  contain  the  characters  "  <  "  or 
Example: 

TERPl>  is  equivalent  to  TERM  >  ; 

that  is.  is  not  part  oi  the 

identifier. 


4.  An  identifier 
meta-charact  er . 

Example: 

!  BOX  I 


cannot  begin  with 
The  me t a -cha r ac t e r s 
X  *  \  l  1  (  ) 

is  equivalent  to 
"I"  is  not  part  of  t 
(but  "I"  is  !  )  . 


a  digit  or  a 
are  listed  below: 


I  BOX  I  ! 
e  identifier 


5  . 


An  identifier  cannot  be  a  keyword,  nor  can  it  begin  with 
a  keyword  followed  by  a  non-* 1 phanumer ic  character.  The 
alphanumeric  characters  are  the  letters  A-Z.  the  digits 
0-9,  and  underscore  .  The  keywords  are  listed  below: 


ATPEND 

BN  F 

BREAK 

BREAKOPT 

CHARS 

CM 

PI ANUMBER 


ENPMOD 1 FY 

ENPPARAM 

EXCHANGE 

LABELS 

MAIN 

MODIFY 

OZERO 


PAGEW l DTH 
PARAMETER 
PLOT 

PLOTLABEL 
PR  1 NTBNF 
PRINTPLOT 
SYM 


Examp  1 e . 


PARAMETER-LIST  is  equivalent  to  PARAMETER 


-LIST  :  that  is.  keyword 
PARAMETER  followed  by 
identifier  -LIST.  But 


PAR AMETER_L I  ST  is  a  single  identifier. 


Note  that  meta-characters  (except  "<"  and  ">")  which 
follow  an  identifier  but  are  not  intended  to  be  part  of  the 
identifier  name  MUST  BE  SEPARATED  FROM  THE  IDENTIFIER  BY 
SPACE  OR  ENP-OF-LINE.  Also,  the  string  " PLOT (  1  5  .  0) "  is  not 
an  identifier  (since  PLOT  is  a  keyword!;  it  is  equivalent 
to  "PLOT  (  15  .  0  )". 


Blanks  may  not  be  embedded  in  keywords. 
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3.3  Constants 


INTVOCR 


■Spirit  y 


suri- 


-tfreiry 


T 


T 


In  Syndia.  constants  are  unsigned  integers 
point  real  numbers.  In  real  numbers,  at  least 
must  precede  the  decimal  point.  Blanks  may  not  be 
in  numbers. 


or  t 1 x  e d 
one  digit 
embed d ed 


Examples : 
0 

1 . 7 

0  .  1  6  S  3 
2  2  0  0  1 


1 
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4 . 0  PARAMETER  SECTION 


WMWWCTCT  SECTION 


<D— ■ 


SPceincoTiow  f- 


POamgTDI  SeCC  IF  I  CATION 


S  ynd i a  generates  two  output  files:  a  lineprinter 
listing  showing  the  input  with  other  optional  output,  and  a 
second  file  containing  instructions  for  the  hypothetical 
plotter.  In  the  parameter  section,  the  user  may  specify  up 
to  eight  parameters  which  indicate  the  nature  of  this 
output.  These  are  discussed  in  turn: 


4 . 1  PRINTPLOT 

PRINTPLOT  specifies  that  the  lineprinter  listing 
include  plots  of  the  several  diagrams,  drawn  with  standard 
ASCII  characters  for  output  on  an  ordinary  lineprinter. 
This  is  useful  if  it  is  inconvenient  to  obtain  plotter 
drawings  every  time  Syndia  is  run  during  the  BNE  debugging 
process.  The  integer  argument  specifies  the  default  width 
in  columns  to  be  used  for  the  plots.  (If  this  default  value 
is  too  small  for  some  diagram,  then  the  smallest  possible 
width  will  be  used.) 
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4.2  PRINTBNF 

PRINTBNF  specifies  that  Syndia  include  in  the  listing 
the  final  BNF  resulting  after  any  symbol  substitutions  have 
been  carried  out.  The  integer  argument  gives  the  width  in 
columns  of  the  BNF  listing.  Syndia  makes  no  attempt  to 
"pretty  print"  this  listing. 


4 . 3  PAGEWI DTH 


PAGEWIDTH  gives  the  width  in  columns 
which  the  listing  is  to  be  printed.  The 
not  include  the  first  column,  which  Syndia 
blank  ’  '  for  Fortran  carriage  control, 

parameter  is  present,  a  page  width  of  130 


of  the  page  on 
number  given  does 
always  sets  to 
When  no  PAGEWIDTH 
s  assumed. 


Syndia  will  allow  the  widths  given  with  PRINTPLOT  and 
PRINTBNF  to  exceed  the  page  width.  In  such  cases,  Syndia 
will  split  the  output  at  the  page  boundary. 


4.4  PLOT 


The  PLOT  parameter  specifies  that  instructions  for  the 
hypothetical  plotter  be  output.  The  first  number  argument 
gives  the  default  width  in  centimeters  for  the  syntax 
diagrams.  (15  cm.  is  just  under  6  inches.)  The  second 
argument  gives  the  width  of  the  characters  to  be  used  in  the 
diagrams.  Syndia  will  NOT  check  to  ensure  that  the 
character  size  specified  is  not  too  big. 


The  plotter  drawings  will  be  scaled  to  resemble  the 
lineprinter  drawings  obtained  by  PRINTPLOT.  If  PRINTPLOT  is 
not  specified,  the  plotter  drawings  will  resemble 
lineprinter  plots  100  columns  wide. 


There  are  two  possible  special  values  for  the  second 
argument.  If  the  second  argument  is  zero,  then  Syndia  will 
compute  the  largest  character  size  it  can  use  for  each 
d  rawi ng . 


The  other  possible  special  value  for  the  second 
argument  is  equals-sign  "=".  This  value  causes  Syndia  to 
use  the  same  character  size  used  in  the  lineprinter  plots, 
scaled  by  the  difference  in  sizes  between  the  lineprinter 
and  plotter  drawings.  This  character  size  will  be  somewhat 
smaller  than  the  size  computed  if  the  second  argument  is 
zero . 


•••NOTE***  The  current  version  of  the  graphics  editor 
at  SCORE  handles  only  a  single  character  size.  0.1683  cm. 
Syndia  will  automatically  select  this  size  unless  it  is 


I 


> 
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forced  (by  excessive  drawing  density)  to  choose  a  smaller 
size.  It  is  therefore  recommended  that  the  user  set  the 
second  PL OT  nrgument  to  zero  (or.  perhaps,  to  0.1683). 


'*.5  DIAN UMBER 

A  diagram  generated  by  Syndia  is  ordinarily  labeled 
only  with  the  nonterminal  name  from  the  left  hand  side  of 
the  corresponding  production.  If  DIANUMRER  is  specified, 
then  Syndia  will  precede  this  label  with  the  integer 
preceding  the  production  in  the  BNF  section  (see  Section  6). 


4.6  OZERO 

If  OZERO  is  specified,  then  Syndia  will  change  all  O’s 
("oh")  to  0's  ("zero")  and  vice  versa  in  the  lineprinter  and 
plotter  drawings.  This  is  useful,  for  example,  if  the 
plotting  software  slashes  O's  ("oh")  while  the  user  wants  to 
slash  O's  ("zero"). 


4.7  LABELS 

In  its  internal  representation,  each  syntax  diagram  has 
all  of  its  nodes  numbered,  where  a  node  is  a  corner  or 
intersection.  The  user  may  refer  to  these  node  numbers  in 
modifications  to  alter  the  layout  of  the  diagram.  LABELS 
specifies  that  these  node  numbers  will  appear  in  the 
lineprinter  drawings  generated  by  PRINTPLOT. 


4.8  PLOTLABEL 


PLOTl.AREL  specifies  that  the  node  numbers  mentioned 
above  will  appear  in  the  plotter  drawings  generated  by  PLOT. 


SYNDIA  USER'S  GUIDE 


I'  a  q  e  II 


5.0  SYMBOL  DECLARATIONS 


WNMl  HrtNITtON 


Normally,  the  value  of  an  identifier  is  the  name  as  its 
name.  for  example,  the  identifier  REGISTER  has  as  its  value 
the  character  string  'REGISTER*.  However,  identifiers  mav 
he  assigned  different  values  in  the  symbol  declaration 
section.  When  these  identifiers  appear  later  in  the  ONE, 
they  are  replaced  by  their  values,  the  character  s  t  r i n  a  s 
given  in  the  declarations.  The  replacement  strings  are 
always  treated  as  identifiers,  even  if  they  contain  embedded 
blanks,  me t a - ch a r ac t e r s ,  or  keywords.  String  replacement  is 
not  recursive;  for  example,  after 
B  =  'C'  , 

A  =  '  B  '  , 

the  value  of  A  is  'B',  not  'C'.  Note  that  any  printing 
character  may  be  used  as  the  delimiter.  The  replacement 
string,  like  all  identifiers,  must  not  exceed  MO  characteis 
in  length. 

Examples  s 

SYM  L (  =  ' (  ’  ,  R  )  =  '  )  '  . 

PX  *  ’X* ,  C ,  *  '  ,  *  . 

SHORT  «  /LONGER  CHARACTER  STRING/; 
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6 . 0  BNF  SECTION 


•ACTION 


NMiriCATiow}-^  «<oo*o®irv> 


The  BNF  section  contains  the  productions  for  which 
syntax  diagrams  are  to  be  generated.  This  section  may  also 
contain  modifications  which  alter  the  layout  of  specified 
diagrams.  Productions  and  modifications  may  be  mixed  in  any 
order . 


Syndia  draws  one  syntax  diagram 


performs  absolutely 
being  described  makes 
Syndia  is  to  draw 
not. 


production 


no  checking  to  ensure  that  the  grammar 
any  sense;  the  sole  function  of 
the  diagrams  specified,  nonsensical  or 


The  integer  preceding  each  production  appears  before 
the  label  in  the  syntax  diagram  if  the  DIANUNBER  parameter 
is  given.  In  addition,  the  integers  serve  as  "handles"  for 
the  modifications.  All  modifications  preceded  by  a  given 
integer  are  applied  to  all  productions  preceded  by  the  same 
number.  (The  same  number  may  precede  several  productions.) 
Note  that  the  integer  in  front  of  a  production  or 
modification  marks  the  end  of  the  preceding  production. 


T 


-  w6wrtw*iwt  > 


IKftTiripn 


<>> 


TtIMINM. 

- ^TSWTFfPr) - —  -♦ 

S  y  n  d  i  a  production  syntax  is  quite  similar  to  normal 
RNF.  Syndia  has  special  notation  tor  •- closure.  *  closure, 
and  lists.  which  allows  the  efficient  generation  of 
aesthetic  diagrams.  The  syntax  is  illustrated  hy  examples 
below  in  which  Syndia's  notation  is  contrasted  with  standard 
BNF  . 

In  the  simplest  production,  the  right-hand  side  is  s 
non-empty  sequence  of  terminals  and/or  nonterminals.  Thr 
left-  and  right-hand  sides  may  be  separated  either  hy  **  s  i  « " 
or  by  « 

<  F.X  AMPL  E_  1  >  :!■  B  <C>  <D  E>  "STAR 

CHAMP LA. I 


- <03 


Note  the  different  shapes  of  the  boxes  for  terminals  and 
nonterminals.  Multiple  productions  for  the  same  nonterminal 
may  be  written  as  a  single  production  with  the  several 
alternatives  separated  by  slashes! 
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BN  F  : 


Synd \ a : 


<  E  X  AM  P  L  E_2  >  :  : *  B 

<  E  X  A  M  P  L  E_  2  >  <C>  ♦  <D> 

<  EXAMPLE_2>  :  :  =  XYZ 

<  EX  AMP  L  E_2  >  ::  =  B  /  <C>  ♦  <D>  /  XYZ 


IKMPUJ 


f — 4I> 


-O - 

-<**£) - 


-Qh 


Opt i ona 1  strings 
BNF  : 

Syndia: 


in  Syndia 

are 

enc 

1  os  ed 

i  n 

square  brackets 

<  EX  AMP  L  E_ 

3>  :  i 

:  =  B 

<C> 

<  EX  AMP  L  E_ 

3  >  :  : 

:  =  B 

X  Z 

<C> 

<  EX  AMP  L  E_ 

3  >  :  : 

:  =  B 

1  X 

Z  1 

<C> 

Plus-closure  is 
BNF  : 

Syndia: 


denoted  by  enclosing  text  in  "X"  and  "  \  "  : 


<  EX  AM  P  L  E_4  > 

<  E  X  AMP  L  E  4> 


:  :  =  Q 

:  :  =  <  EX  AM P  L  E_4  >  Q 


<  E  X  AM  P  L  E_4  >  :  : =  X  Q  \ 


£ 


1 


Star-closure  is  indicated  by  adding  a  "A"  to  the  above 
notation: 


BNF:  <  EX  AMP  L  E_5  > 

<  EX  AM  P  L  E_5  > 

syndia:  <EXAMPLE_5> 

CNMPll.* 


nu  1  1 

<EXAMPLE_5>  »•« 

X  $  •*«  \ 


£ 


<m> - 

.  _  ■ 


Finally,  Syndia  has  a  special  list  notation  which  may  be 
regarded  as  an  extension  of  •-closure: 
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BNF:  <  EX  AMPL E_6  >  ::=  <LIST  ELEMENT> 

<EXAMPLE_6>  ::=  <EXAMPLE_6>  <LIST  SEPARATOR> 

<  L 1  ST  ELEMENT> 

Syndia:  <EXAMPLE_6>  ::=  %  CLIST  ELEMENT>  $ 

<  L I  ST  SEPARATOR>  \ 


naruj 


The  above  constructs  may  be  combined  and  nested  to  any 
degree,  with  parentheses  used  where  necessary  to  achieve  the 
proper  grouping: 

<  EX  AMPL  E_7  >  A  (  B  l  C  )/*/.$  D  \  E  /  F  )  \ 


6 . 2  Mod ifications 

MODIFICATION 


Seven  different  modifications 
altering  the  appearance  of  a  diagram. 


are 


avai lable 


for 
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CHARS 

The  CHARS  modifier  sets  the  width  in  columns  of  the 
lineprinter  drawing  for  the  associated  product ion( s  )  ,  If 
CHARS  is  not  specified,  then  Syndia  will  use  the  default 
width  given  with  PRINTPLOT  (or  100  if  P  R l NT  P  LOT  was  not 
specified).  Recall  from  Section  *1  that  the  width  chosen  for 
the  lineprinter  drawing  can  affect  the  appearance  of  the 
plotter  drawing. 


CM 

The  CM  modifier  sets  the  width  in  centimeters  of  the 
plotter  drawings  for  the  associated  production(s) ,  If  CM  is 
not  specified,  then  Syndia  will  use  the  default  width  qivrn 
with  PLOT. 


EXCHANGE.  MAIN,  and  APPEND 

The  EXCHANGE.  MAIN,  and  ATP END  modifiers  specily 
horizontal  paths  which  are  to  he  moved  in  some  fashion.  The 
horizontal  paths  are  identified  by  the  numbers  assiqned  to 
their  left-most  nodes.  These  node  numbers  may  be  obtained 
by  specifying  LABEI.S  or  PI.  OTLABEt.  as  described  in  Section  U  . 
After  modifications,  the  node  numbers  may  chanqe.  but  these 
new  node  numbers  are  NOT  valid  for  use  in  new  modifications. 
The  user  should  always  use  the  node  numbers  from  the 
unmodified  diagram. 

The  EXCHANGE  modifier  identifies  two  horizontal  paths 
which  are  to  be  interchanged. 


t 


■CTONi  INCMANKO.?) 

I  1  4 


arm i  D<awm.7) 
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The  MAIN  modifier  specifies  a  horizontal  path  which  is 
to  be  drawn  in  line  with  the  entry  and  exit  lines  at  the  end 
branch  points. 


Krone  (MINIS  l 


«ntR  (MINIS! 


" M  A  I N ( p 1 . pk)"  is  equivalent  to  "M A  I N ( p  1)  i  .  .  .  i M A  I  N ( pk  )  " . 


The  APPEND  modifier  specifies  a  horizontal  path  which 
is  to  be  drawn  in  line  with  the  horizontal  path  above  it. 

ntm  arrcNOiS! 


—HD — 
HZ) — 
-HD — 


ar Tft  areciM(S) 


II  13 


"APPEND(p1,..,pk)"  is  equivalent  to 

"APPEND! pi  )»  .  .  t  APPEND ( pk  1  " . 


BREAK 

The  BREAK  modifier  identifies  a  node  where  n  sin air 
horizontal  path  should  be  broken  into  two  levels  The  node 
numbers  should  always  be  taken  from  the  unmodified  drawtna 
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urn*  HMio 


< 


"BREAK ( p 1  .... pk  )  "  is  equivalent  to  "  B  R  E  A  K  (  p  1  )  ;  .  .  ;  B  R  E  AK  (  pk  )  "  . 


BREAKOPT 

The  BREAKOPT  modxlier  causes  Syndia  to  au  t  cun  a  t  i  c  a  1  1  y 
insert  BRFAK's  where  required  to  make  the  lineprinter 
diagram  fit  in  the  uidth  specified  in  PRINTPLOT  (or  100 
columns  if  PRINTPLOT  was  not  specified). 
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7 . 0  HOW  TO  USE  SYNDIA 

Any  file  name  used  by  Syndia.  Syngra.  or  the  graphics 
editor  must  be  a  valid  TO PS-10  file  specification  in  which 
the  name  has  not  more  than  six  characters  and  the  extension 
has  not  more  than  three  characters.  A  TOPS-IO  device  spec 
may  precede  the  name,  and  a  directory  spec,  if  present,  must 
be  in  the  form  of  a  PPN  following  the  extension.  (The  PPN 
for  a  directory  may  be  found  by  the  TRANSLATE  command.) 
Hence.  in  its  most  general  form,  a  valid  file  specification 
has  the  f  orma  t 

deviname.extlppn) 

The  procedure  for  running  Syndia  at  SU-SCORE  follows 

1.  Prepare  your  Syndia  input  file. 

2.  Give  the  EXEC  command  to  run  Syndia: 

SSYND1 A 

3.  Syndia  will  prompt  lor  INPUT.  OUTPUT,  and  MAINTLOT  file 
names.  The  INPUT  file  is  the  file  prepared  in  Step  1 
The  OUTPUT  and  MA1NFL0T  files  will  contain  the 
lineprinter  listing  and  the  hypothetical-plotter 
instructions,  respectively. 

If  you  follow  any  file  name  in  this  step  with  "/SYNGRA". 

as  in 

INPUT  *  SYNTAX  .  IN/SYNGRA 

then  Syndia  will  automatically  start  Svngra  if  no  errors 
are  found  in  the  input.  If  the  input  contains  errors. 
Syndia  will  print  a  message  "ERROR(S)  IN  INPUT"  at  the 
terminal.  The  error  messages  may  then  be  found  in  the 
OUTPUT  listing  file. 

4.  If  you  did  not  specify  "/SYNGRA"  when  you  tan  Syndia. 
then  you  may  start  Synora  bv  giving  the  EXEC  command 

SSYNGRA 

5.  Syngra  will  prompt  for  the  MAINFIOT  file  name.  Respond 
with  the  same  MAINPLOT  file  name  you  gave  Syndia  If 
you  follow  this  file  name  with  "/EDIT",  then  Syngra  will 
automatically  start  the  graphics  editor  when  it  is  done 

6 .  The  function  of  Syngra  is  to  convert  t  ti  e  MAINPLOT  output 
from  Syndia  into  a  form  readable  bv  the  graphics  editor 
In  general  Syngra  will  generate  many  output  files.  Each 
output  file  corresponds  to  one  screenful  of  diagrams  on 
the  Tektronix  4014.  Syngra  automatically  puts  as  many 
diagrams  as  it  can  in  one  screenful:  conversely,  if  one 
diagram  is  too  big  to  fit  on  the  screen.  Syngra  will 
split  it  into  as  many  parts  as  necessary,  with  enough 
overlap  between  parts  to  allow  easy  cut  and  paste. 

During  execution.  Syngra  will  do  three  things  at  the 
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terminal  . 

1.  Syngra  will  print  the  sequence  number  and  name  of 

each  diagram  as  it  is  encountered  in  the  input . 

C .  Syngra  will  prompt  for  output  file  names  as 

required.  When  choosing  the  output  file  names, 
remember  ttiat  the  graphics  editor  will  be  expecting 
input  files  with  the  extension  ".1NT"  or  " . SYM” . 

3.  Syngra  will  ting  the  appearance  of  character  sires 

not  supported  by  the  graphics  editor.  If  you 

specified  a  character  width  of  rero  in  the  FLOT 
parameter.  then  this  error  condition  indicates  a 
diagram  that  is  too  crowded.  T h i s  may  be  corrected 
by  adding  modifications.  splitting  t h e  production 
into  several  shorter  productions.  increasing  the 
plotter  diagram  width.  or  tin  some  casesi  by 
DECREASING  the  1 ineprinter  diagram  width. 

7.  You  must  be  logged  in  at  the  Tektronix  4  0  terminal  in 
order  to  run  the  graphics  editor.  If  you  did  not 
specify  "/EDIT”  when  you  ran  Syngra.  then  you  may  start 
the  editor  by  giving  the  EXEC  command- 
as U DSC 

The  use  of  the  editor  is  described  in  a  manual  in  the 
ERL  terminal  room  next  to  the  4014  terminal.  The  manual 
is  also  on-line  at  SU-SCORE  in  DOC : SUDSC . MAN .  The  use 
of  a  small  subset  of  the  available  commands  will  suffice 
to  generate  the  diagrams. 
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8.0  EXAMPLE  FROM  ZUERICH  SHOWING  USE  OF  SYNDIA  AT  SU-SCORE 
3 

3; 

a;  TYPE  OUT  THE  INPUT  FILE 
3; 

a ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;  ; 

a; 

aTYPE  PS : <CSL . DA . SYNDI A>SME3 
PARAMETER 

P  R I  NT  P  LOT (50); 

PLOT  C  10,0); 

PAG  EW I DTH ( 5  0  )  ; 

LABELS; 

PRINTBNFC  50 )  ; 

OZERO 

ENDPARAM 

BNF 

SYM 

A  1  =  /  /,  L(  =  /(/,  R)  =  /)/,  SLASH  =  ./.; 

1  <  T1  >  ::=  X  B$  C  \ 

1<T2>  ::=5JB$C\ 

20  <  T3  >::=(<  A1  >!!  L(  C  R)  \  ) 

1  MODIFY  CHARS (40)  ENDMODIFY 
3  MODIFY  APPEND! 5)  ENDMODIFY 
3  <T3  Jl  U  T5  R))  -*  A  /  B  /  C 
5  <T6  >  ::=  <  A  >  SLASH  <B>  SLASH/ 

3  MODIFY  MA I N ( 7 )  ENDMODIFY 
0 

a; 

a ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;  ; 

3; 

a;  GET  PS : <CSL  .  DA . SYNDI A>  PPN 

a; 

a ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;  ; 

a; 

aTRANSLATE  PS : <CS L . D A . S YN D I A> 

PS : <CSL . DA . SYNDI A>  CIS)  PS  :  (  4  .  1  0  0  7  ] 

3; 


J 


r 
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3 ;  ;  ;  ;  ;  ;  ;  :  ;;;;;;;  ;  ;  ;  ;  ;  ;  ;;;;;;;  ; 

3; 

3;  NOW  RUN  SYNDIA  AND  SYNGRA 
3; 

3 ;;;;;;;;; j ;;;;;;;;;;;;;;;;;;  ; 

3 ; 

3SYNDI  A 


INPUT 

=  PS : SME31 9 , 

.  1007  1/SYNGRA 

OUTPUT 

=  SME3. 

L  I  S 

MAINPLOT 

=  SME3. 

SYO 

""STARTING  SYNGRA 

*  » 

MAINPLOT 

=  SME  3 . 

SYO 

NEW  OUTPUT  FILE  STARTING 

IN  DIAGRAM 

OUTPUTFILE-  SME3. 

I  NT 

STARTING 

DIAGRAM 

NO  . 

1  : 

T  1 

STARTING 

DIAGRAM 

NO  . 

•3  , 

C  • 

TZ 

STARTING 

DIAGRAM 

NO  . 

3  : 

T  3 

ST  ART  I NG 

DIAGRAM 

NO  . 

9  : 

T  3  I 

STARTING 

DIAGRAM 

NO  . 

5  : 

T  6 

EXIT 
3  ; 

3;  ;  ; 
3  ; 

3  ; 

3; 


LOOK  AT  THE  OUTPUT  LISTING 


3  ;;;;;;;;;;  ;  ;  ;  ;  ;  ;;;;;;;;;;;;;  ; 

3; 

3TYPE  SME3.LIS 

SYNDIA  VERSION  JUNE  9 .  1979  /  SU-SCORE 


PARAMETER 

PR  I NTPLOT  (  50  )  ; 
PLOT (  10.0); 

P AGEWIDTHI 50  )  ; 
LABELS ; 

PR  I NTBNF ( 50  )  ; 
OZERO 
ENDPARAM 


BNF 

SYM 

A  1  -  t  /.  Lt  =  /(/,  R )  =  /)/,  SLASH 
I  <  T1  >  !!=  !i  B$  c  \ 

1  <  T2  >  ;:=  U  1  C  \ 

JO  <  T3  >::=[<  A1  >  S  L(  C  R)  \  ) 

1  MODIFY  CH A  RS ( 9  0 )  ENDMODIFY 
3  MODIFY  A  F  F  EN  D ( 5)  EKDMODIFY 
3  <T3  A1  L(  T5  R)>  =  A  /  B  /  C 
5  <T6>  <  A  >  SLASH  <B>  SLASH/ 

3  MODIFY  M A  I  N ( 7  )  ENDMODIFY 

0 


i 
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TABLE  OF  ABBREVIATIONS 

<--  •  • 
<--  '(• 
<--  ')• 

< —  •/• 


A  1 

L  ( 

R  ) 

SLASH 


BACKUS  -  NAUR  -  FORM 

1  <  T 1  >  ::=  X  ' B  $ '  ' C  ’  \ 

2  <  T  2  >  ::=  X  ' B '  *  ' C '  \ 

3  <T3>  ::=  [<  >X  '('  'C'  ')'  \  J 

<  T  3  (  T  5  )  >  ::=  'A'/’B'/’C' 

5  <  T6  >  ::=  <  A  >  '/'  <  B  >  'SLASH/' 


END  OF  BACKUS-NAUR-FORM 


T  1 

5  6 

-< - 

I  A 

V  I 

1  3  --  7  -  4  2 

- j - *b$* - #C# - 


T  2 

5-6 
-< - «C* - 

I  -  A 

V  I 

1  3-4 

- j - »B* - j 
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5i;  PLOTTER  DIAGRAMS  MAY  NOW  BE  OBTAINED 
3;  BY  RUNNING  SUDS  2 

3) 


Tt 


rt 
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